home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / ascii / makecsv / !MakeCSV / !Help < prev    next >
Text File  |  1993-04-08  |  6KB  |  156 lines
  1. !MakeCSV  Release 2   Copyright Justin Williams 1992,1993
  2.  
  3. The purpose of !MakeCSV is to take a text file, in normal format and convert it into a file in CSV format. 
  4.  
  5. Why would you want to do this ? 
  6.  
  7. Well, I had a list of names of files, with dates, and sizes. I wanted to sortthem into size order using Pipedream, but could not because the info was
  8. all on the same line. It was all nicely columnised, but this didn't help 
  9. Pipedream. I had to do the conversion using Quattro Pro on the PC, and when
  10. a PC can do something my Archie can't I get annoyed. Hence this program
  11. was born.
  12.  
  13. Instructions :
  14.  
  15. Drag your text file onto the !MakeCSV icon (on the icon bar). A window will
  16. pop up showing the 1st 2 lines of the text file, and its guess at how you
  17. want the columns. Each set of ttt's or nnn's indicates a column, and the
  18. format. (text or numerical).  If you want to change this, just edit it. When
  19. it looks ok, then select the make CSV button and drag the CSV file icon to
  20. the filer window.
  21.  
  22. There are options to strip leading and trailing spaces. These are do as they
  23. say, and strip the leading or trailing spaces.
  24.  
  25. Thats it. Now for the copyright bit.
  26.  
  27. This program is not PD, but is Authorware. That means that I retain the
  28. copyright to it. You may distributed it to anybody you like, provided that
  29. all the files are included and that it remains unaltered.
  30.  
  31. It may be altered by you for your own personal use, but the altered version
  32. may not be distributed. Send it to me, I will give it a version number and
  33. give you the credit, and then make it available for general distribution.
  34.  
  35. If you find this program useful, please send in a donation of £1 to the 
  36. South African Archimedes User Group, or if getting hold of pounds is a 
  37. problem, then send a blank disc or two.
  38.                                        
  39. I ask that all users of this program register. Registration is FREE, and
  40. there are no advantages to registration, other than me knowing who is using
  41. my program. The donation is optional!
  42.                                               
  43. Please note : I take all responsibility for any bugs in the program, but no
  44.               responsibility for any damage that they may cause. 
  45.  
  46. If you need to contact me to report any bugs etc, please write to :
  47.  
  48. Justin Williams
  49. PO Box 1051
  50. Wandsbeck
  51. 3631
  52. Natal
  53. South Africa
  54.  
  55. E-Mail : williamj@shrike.und.ac.za (Until January 1994)
  56.  
  57. 8 April 1993
  58.  
  59. Version 1.0
  60.  
  61. - first release
  62.  
  63. Version 2.1
  64.  
  65. - Alterations of the field icon now work correctly when multiple spaces
  66.     separate a field
  67. - Inter application transfers work (but the source file must be on disc!)
  68. - The leading/trailing space options have been enabled
  69. - The program is no longer public domain, but Authorware.
  70.  
  71. Version 2.2
  72.  
  73. - Fixed up the menus to work with Risc OS 3 
  74. - Increased the size of the view window to allow for 255 char widths
  75. - Compacted the source code using Risc OS 3's crunch command with all options
  76. - Reduced the slot size of the program to 48k
  77. - Released onto Newcastle
  78.  
  79. Version 2.3
  80.  
  81. - included option to allow end of line markers other than <return>. 
  82. - allowed the reading of fixed length records which have no end of record
  83.    marker eg. DBase files
  84.    - the record length limit of 255 characters makes the above feature near
  85.      to useless.
  86. - re-worked some small pieces of the code. No functional difference.
  87. - moved the icons in the main window around to make space for the new one
  88. - tested crunching with !BasCrnch2, is far more efficient than Basic's crunch
  89.   but, using Basic Crunch before !BasCrnch2 is even more efficient!
  90.  
  91. Original Size      : 11880
  92. Basic's Crunch     : 9179
  93. BasCrunch 1.02     : 5494
  94. Crunch + BasCrunch : 5323
  95. BasCrunch + Crunch : 5494
  96.  
  97. Interesting huh?
  98.  
  99. Version 2.3.1
  100.  
  101. - further reduced the slotsize of the program to 32k
  102.    - how are you supposed to determine the slotsize ???
  103. - removed a newly introduced bug which occurred with EOF when using non-13
  104.   end of line markers
  105. - placed close icon on save box. Window now in new format.                 
  106. - second release to Newcastle (first one had a corrupted template file)
  107.  
  108. Version 2.3.2
  109.  
  110. - removed the old menu system and introduced Petrov Software's system, this
  111.    is much superior, and doesn't need to be "kludged" to work under Risc OS 3
  112. - allow the user to press "RETURN" in the 'End of line' field to redo 
  113.    descriptor automatically without having to select it on the menu
  114. - had to introduce an exceptions list for variables to be crunched. The 
  115.    functions called by the menu handler must not be crunched!
  116.  
  117. Please note : the new features in this version are not fully functional and 
  118.               still need a bit of work. Converting plain text files to CSV
  119.               will work fine, but fixed length record files needs some 
  120.               refinement.
  121.  
  122. Version 2.4
  123.  
  124. - altered the template slightly to make space for the TSV option
  125. - can now have fields which are not seperate by spaces, simply use different
  126.    case eg. TTTTtttt will give two fields (text) of 4 chars each.
  127. - implemented the CSV and TSV choice option. The icon changes to suit the
  128.    type. (Is the TSV filetype supposed to be TEXT??)
  129. - removed the program version number from the template, is now filled in by
  130.    the program at RunTime
  131. - introduced an error box, pretty useless though as doesn't allow recovery
  132. - started using !Zap to edit the program. Is great, almost as good as the
  133.    old ArmBE. I still miss the LIST IF command of BASIC. The search command
  134.    could also be improved, but, it is the best BASIC editor around, better
  135.    than !DeskEdit. Try it see!
  136. - the error box now doesn't quit! Could result in infinite loops though, but
  137.    now the data isn't lost.
  138.  
  139. Version 2.5
  140.  
  141. - solid drags now work, and only when the CMOS bit is set. Doesn't bother to
  142.    check it is a Risc OS 3 machine, so Risc OS 2 machines with the bit set
  143.    will have a problem.
  144. - interactive help implemented, didn't do much for the code length, went from
  145.    around 5500 bytes to 7800 bytes. Anyway, if people is it it might be worth
  146.    it. I didn't increase the slot size, so if you have any problems, just
  147.    increase it to 48k.
  148.  
  149. Possible future enhancements :
  150.  
  151. - Allow the guess format option to be used on lines other than the 1st two
  152. - Allow the maximum input line length to be >255 characters
  153.     (will require major re-write though!)
  154. - Speed up the program
  155. - Make the window and icons re-size according to the file being converted
  156.